package com.ruoyi.campus.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.ruoyi.campus.domain.AlarmRecord;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.Date;
import java.util.List;
import java.util.Map;

/**
 * 报警记录Mapper接口
 * 
 * @author campus-alarm
 * @date 2024-01-01
 */
@Mapper
public interface AlarmRecordMapper extends BaseMapper<AlarmRecord>
{
    /**
     * 查询报警记录列表
     * 
     * @param alarmRecord 报警记录
     * @return 报警记录集合
     */
    List<AlarmRecord> selectAlarmRecordList(AlarmRecord alarmRecord);

    /**
     * 查询报警记录详情（包含关联信息）
     * 
     * @param alarmId 报警ID
     * @return 报警记录
     */
    AlarmRecord selectAlarmRecordDetail(@Param("alarmId") Long alarmId);

    /**
     * 根据报警编号查询报警记录
     * 
     * @param alarmCode 报警编号
     * @return 报警记录
     */
    AlarmRecord selectAlarmRecordByCode(@Param("alarmCode") String alarmCode);

    /**
     * 查询用户的报警记录
     * 
     * @param userId 用户ID
     * @param userType 用户类型
     * @return 报警记录集合
     */
    List<AlarmRecord> selectAlarmRecordByUser(@Param("userId") Long userId, @Param("userType") Integer userType);

    /**
     * 查询学校的报警记录
     * 
     * @param schoolId 学校ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 报警记录集合
     */
    List<AlarmRecord> selectAlarmRecordBySchool(@Param("schoolId") Long schoolId, 
                                              @Param("startTime") Date startTime, 
                                              @Param("endTime") Date endTime);

    /**
     * 查询待处理的报警记录
     * 
     * @param schoolId 学校ID（可选）
     * @return 报警记录集合
     */
    List<AlarmRecord> selectPendingAlarmRecords(@Param("schoolId") Long schoolId);

    /**
     * 查询紧急报警记录
     * 
     * @param schoolId 学校ID（可选）
     * @return 报警记录集合
     */
    List<AlarmRecord> selectEmergencyAlarmRecords(@Param("schoolId") Long schoolId);

    /**
     * 查询超时未处理的报警记录
     * 
     * @param timeoutMinutes 超时分钟数
     * @return 报警记录集合
     */
    List<AlarmRecord> selectTimeoutAlarmRecords(@Param("timeoutMinutes") Integer timeoutMinutes);

    /**
     * 查询实时报警数据（最近24小时）
     * 
     * @param schoolId 学校ID（可选）
     * @return 报警记录集合
     */
    List<AlarmRecord> selectRealtimeAlarmData(@Param("schoolId") Long schoolId);

    /**
     * 统计报警数据
     * 
     * @param schoolId 学校ID（可选）
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 统计结果
     */
    Map<String, Object> selectAlarmStatistics(@Param("schoolId") Long schoolId, 
                                            @Param("startTime") Date startTime, 
                                            @Param("endTime") Date endTime);

    /**
     * 按时间段统计报警数量
     * 
     * @param schoolId 学校ID（可选）
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @param groupBy 分组方式：hour、day、week、month
     * @return 统计结果
     */
    List<Map<String, Object>> selectAlarmCountByTime(@Param("schoolId") Long schoolId, 
                                                   @Param("startTime") Date startTime, 
                                                   @Param("endTime") Date endTime, 
                                                   @Param("groupBy") String groupBy);

    /**
     * 按报警类型统计
     * 
     * @param schoolId 学校ID（可选）
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 统计结果
     */
    List<Map<String, Object>> selectAlarmCountByType(@Param("schoolId") Long schoolId, 
                                                   @Param("startTime") Date startTime, 
                                                   @Param("endTime") Date endTime);

    /**
     * 按地理位置统计报警热点
     * 
     * @param schoolId 学校ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 热点数据
     */
    List<Map<String, Object>> selectAlarmHotspots(@Param("schoolId") Long schoolId, 
                                                @Param("startTime") Date startTime, 
                                                @Param("endTime") Date endTime);

    /**
     * 批量更新报警状态
     * 
     * @param alarmIds 报警ID列表
     * @param handleStatus 处理状态
     * @param handlerUserId 处理人ID
     * @return 更新数量
     */
    int updateAlarmStatusBatch(@Param("alarmIds") List<Long> alarmIds, 
                              @Param("handleStatus") Integer handleStatus, 
                              @Param("handlerUserId") Long handlerUserId);

    /**
     * 自动分配报警处理人
     * 
     * @param alarmId 报警ID
     * @return 更新数量
     */
    int autoAssignAlarmHandler(@Param("alarmId") Long alarmId);
} 